label
Type
property
Summary
Specifies the string shown in a stack window's title bar, or a text label to be displayed on the specified object if its showName property is true.
Syntax
set the label of <object> to <labelString>
Description
Use the label property as a user-visible replacement for an ungainly name, or to change the visible name of a window or object when changing the actual name would require changing code that refers to it.
If a button's menuMode is either "option" or "comboBox", the button's label is the text of the currently selected menu option. Setting the label property changes the currently selected option. (To change the currently selected option while sending the appropriate message, set the button's menuHistory instead.)
To create a multiple-line label for a button or graphic, place a return constant in the label.
If an object's label is empty, the object's name property is displayed instead. In this case, the expression the effective label of button reports the button's name property.
To create a blank title bar, set the stack's label property to a space.
Card numbers will not be displayed in the title bar of a stack if its label property is not empty.
Examples
set the label of button 1 to "Hello" & return & "World"
get the label of button "Choices Popup" -- current menu choice
set the label of this stack to the short name of this card
Related
property: name, showName, longWindowTitles, unicodeTitle, acceleratorText, menuHistory, titleWidth
command: constant
function: stacks
glossary: object, property, title bar, message, stack window, group, expression
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile